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NOT TO BE SOLD FOR PROFIT® 
INTRODUCTION i 


This guide has been prepared in order to aid owners of T/S 1000 or T/S 1500 cosputers generate RLE graphics. RLE (Ren ۸ 
Encoded) graphics is a eethod of transaitting encoded graphics inforaation to your coaputer. Any coaputer capable of high 
resolution displays of at least 256 by 192 pixels can display RLE graphics, the T/S 1000 and T/S 1500 are no exceptions. All 
that is needed is the right coabination of hardware/software and an RLE decoder prograa. This guide will describe ۹ 
ct decoding the raw RLE data. If you follow the instructions you too can produce RLE graphics on your CRT terainal and 
printers. 


WERTRARE REQUIREMENTS ` 


Tne sain hardware requirement for both the T/S 1000 and T/S 1500 is a suitable aaount-of RAH. This aust include STATIC RAM 
in the Bt to 16۲ area, which is needed to produce the high resolution displays. This could be, for exaaple, the ‘HUNTER 
BOARD” or "SCRAN BOARD". In addition at least 32K of user RAN aust be available, i.e. ۵646۶ ۰ 


1f you intend to download your own RLE files froe a reeote terainal you will, of course, also need a acdee. 


RLE files are fairly aeaory intensive and can range Iron 3K to 28K or sore in length depending on the picture coaplexity. 
This esans, in the case of the T/S 1000 or 1500, that the largest whole file you can capture at one tiae is slightly less 
than 16۲۰ In order to do this the entire 16K to 32K area aust be open for the RLE download. The ideal scenario then is to 
run your terainal software below the 16K boundary or above the S2K boundary. However, assuaing that the lower STATIC RAR - 
will be reserved for high resolution displays then the terainal program est be placed above 0 


In order ta ren aachine code above 32K on the T/S 1000 you will need to install the Mi KOT aodification, this is not 
recuired on the T/S 1500. If you do not install the Ml MOT sodifscation then the'aaxieua RLE file you can download will be 
on the order of 10K, the resaining RAN will be occupied by your terainal progras. 


SOFTWARE REQUIREMENTS 
The eethod for decoding RLE graphics described herein is dependent upon the softuare used by the writer. Other pragraes say 


work, but I leave it wp to you to aake any changes in the decoder which this sight necessitate. 


The terainal (۳۵9۳۵۵ used is ZX-TERM-80. The eain advantages to this prograe are the high resolution display eodes, user 
friendliness, and relocatability. Relocate 11180 above SZK to open up all of the 16K for RLE data downloads. 


The RLE decoder prograa needs a aethod for plotting the RLE picture. The RLE decoder therefore requires a copy of SRAN 
WISRES EXTENDED BASIC (SHREB). SHREB is an alternate operating systea which persits full control ef the high resoluticn 


FROCEEDURE 


The first thing we need to do is get an RLE file to decode. LOAD 11180 into your cosputer fallow the start up proceedure and 
relocate to 32768. Find a BBS with sose RLE files and download one. Hang up, the RLE file is now stored in the 0 REM DATA 
buffer, SAVE the file a couple of tiees te tape. g 


The RLE decoder needs to have the RLE data transfered to the address starting at 32768. We could add a BASIC PEEK/FOKS.. 
prograa to do this, but this can be very slos, especially on larger RLE files. The first thing we’ll da is add a short ۰ 
routine to do the transfer 18 a flash. 


LOAD the O REM DATA buffer with the RLE file. Once the file is LOADed, POKE 14510,10. Now look at Listing ٩, this is the 
N.C. we want to preface all the RLE files with. The 1 REM line aust always be exactly 21 bytes long. Use the decieal duen to 
POKE the code into the REM line or, alternately, use the key board routine described in Listing 4. The key board 82160 is 
eost convenient especially if you will be doing alot of files. RAND USR 16514 will transfer the RLE file to the 32K area. 


Gace the RLE file is stored at 32K, LOAD SRAM AISRES EXTENDED BASIC. Resave any extraneous lines and also delete line 2 as 
we will rot need the 64 character print routines. Then POKE 18080,208 and 18081,75. Since SHREB is ۱0۵۵۵۵ we could ester a 
decoder antiraly in BASIC, if desired. Listing t is Such a prograa, enter it then RUN to decode the RLE file already stered 
-at 32K, however, de prepared to wait 10 to 20 sinutes to see the final picture, in FAST eode. 


A better eethad is to use the aachine code RLE decoder shown in Listing 2. To enter this into SHREB delete all the ۴ 
decoder lines then create a 2 REM line of at least 131 bytes. Again, use a POKEr prograe to enter the decieal duep. Check 
your final product with the checksua routine shown. Finally, enter the lines froe Listing 3 which is the BASIC portion of 
the N.C. decoder. SAVE to tape a couple of tines then AUN. If everything was done correctly your RLE picture should be 
Czapleted in under 30 seconds, in SLOW eode. You can even watch the picture being foreed. 


The N.C. decoder only returns to BASIC after the entire screen, 192 cixei rows, has been filled. Under noreal conditions an 
FLE decoder should stop when a certain sequence of control codes is encountered at the end of the RLE file. This was not 
gone on this N.C. decoder for a special reason. 


âs noted above, the aaxigue whole RLE file you can download is slightly less than ۰ However, filas over ۱۵۲ can ba 
partially downlcaded. If the RLE file is not teo auch over 16K then eost of the picture wiil still be recovered. Obviously, 
files euch Jarger than 16K aay lose a significant portion of the picture and aren’t worth downloading. 


Since it is possible to download partial PLE files the ending control code sequence will be eissing, this explains why tha 
decoder does not test for thea to locate the end of the file. 


Sose FLE files are seant to display only 256 by 176 resolution (T/S 2068 displays for exaeple) since the ending control 
codes are not used by the decoder the botto 16 lines of such a picture say not be correct. If it doesn’t look right iust 
use the SHREB scroll routines to erase the bottoa part of the picture and then recenter it. 


REFERENCES l 
Breunung, Serd, 1986, 1000 One Chip ۱۵۵-4 Built-in ۶ Syncuare Neus, Vol.4,@1, 8۰10-0۰ 
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RESOURCES 


Silicon Mountain Cosputers 
C-12, Mtn. Station Group Box 
Nelson, BC ۷۱۰ 1 
Canada 


D 


SCRAN BOARD- MVN, BK to 16K, STATIC RAA Board for the T/S 1000 or T/S 1500. Can be used with high resolution software. 
Easily eodified to allow for tuo switchable banks of 8K STATIC RAM or a ۱۵۲-2۴۶۸۵۲۷۲ ۰ 


IX-TERN-80- High resolution tersinal prograa for the T/S 1000-1500. 


SRAM ۷۲۸865 EXTENDED BASIC- High resolution extended basic for the 1/S1000-1500. 


Ni ۷۵۲ ADAPTOR- ۳۱ KOT eodification to run A.C. above 32K. Mo trace cutting or soldering, for T/S 1000 only. 


Godies of other quality high resolutica and aot so high resolution stuff for the T/S 1000-2181-T/S 1500. 


Eater 0 

2340 Gueen St. ۰ 

Toronto, Ontario ME 169 
Canada 


Big-Printer SINCARTIST- Print those RLE screens to a big printer. 


۲1۳6-1-0 213-329-3922 8/1/80 ۰ 


Coppuserve 


THE ZX-TERN EXCHANGE, c/o “Nicolson Nightine ease: (684) _ 3- 


4666 1800-0900 each Bight, all day Suaday. 1 


Listing 1: RLE DECODER BASIC LANGUAGE VERSION. 


۵8 2-۳ BSS 
i REH FAST 
10 REM RLE DECODER, MODIFIED 
FROM PROG. IN VOL. 3 
NO. 2 OF TIME DESIGNS 
MAGAZINE 
20 REM RLE PICTURE DATA MUST 
i START AT 32768, OR 
ج‎ VALUE AT LINE 


30 LET HR=19400 

40 IF USR HR THEN CLS 
SL IF USR HR THEN RUN 
ace ter A=32768 


X= 
420 LET Y= 


191 
e IF PEEK A<>71 THEN LET A=A+ 


440 IF PEEK 6۶71 THEN GOTO 430 


SE E IF PEEK 6872 THEN LET A=A+ 


46@ IF PEEK 84:72 THEN GOTO 450 


LEIT مد‎ l ۳3 


LET C=PEEK A- 
IF rene THEN Gäre 560 


LET X=X+C 

IF X<=255 THEN «0 560 
LET E 5 

LET Y=Y-1 

IF C<@ THEN STOP" 

LET A=A+1 

LET C=FEEK A-32 

IF 06 THEN STOP 

LET 24 

IF Cep THEN GOTO Soo 


LET ۵ 

IF (6۶255 THEN GOTO 662 
LET 222-6 

LET ۷۶۲-4 

IF USR, Wei THEN PLOT X,Y 
LET eee 

LET X H 

IF Bet “THEN GOTO 500 
GOTO 6308 . 


isting 2: RLE DECODER MACHINE CODE VERSION. 


ADDR HEXCODE NAME MNEMONIC ADDR HEXCODE 6 
4EB6~B7 REM2 OR A 4ED1 7E 3 LD A, CHL) 
4EB7 1 OR C 4EDe 0 SUB 20 
88 AA XOR D 4ED4 23 INC HL 
4E89 9B SBC A,E 4ED5 2805 JR 2 NEXT 
4EBA AS XOR C 4ED7 1600 LD D,0O 
۳88 AA XOR D 4ED9 O4 BIT> INC B 
4EBC AB XOR B 4EDA OS DEC B 
4E8D BY OR H 4EDB 3 JR 2 SKP1 
۴۳8۶ AS XOR C 4EDD ES PUSH HL 
4EBF AA A XOR D ` BEDE 60 LD H,B 
4ESO B7 OR A 4EDF 69 AD L,C 
4ES1 76 HALT 4EEO 010001 LD BC,0100 
4ES2e 76 HALT 4EE3 7 AND A 
4£93 210080 DCOD LD HL,STOR . 4EE4 02 SBC HL,BC 
4E96 010000 LD BC, OOOO 4EEG 44 ۰10 B,H 
YESS 1EBF LD E, BF 4EE7 4D ‘LD C,L 
4ESB 7E LUP1 LD A, CHL) VEER 67 LD H,A 
4ESC FE47 CP 47 HEES 3EFF LD A,FF 
4ESE 2803 JR 52 4EEB 1D DEC E 
4EAO 23 INC HL 4EEC BB CP E 
4EA1 8 JR_LUP1 4EED 7C LD ۷۷ 
4EA3 ۴ . LUP2 LD ۵) 4EEE 1 POP HL 
4EAY 6 CP 48 4EEF C8 RET 2 
4EAG 2803 JR 2 INC> 4EFO FS SKP1 PUSH AF 
4EAB 23 INC HL 4EF1 ES PUSH HL 
4EAS 8 ` JR 2 4EF2 DS PUSH DE 
4EAB 23 INC> INC HL 4EF3 CS PUSH BC 
4EAC 7E NEXT LD A, CHL) SEFY 43 LD B,E 
4EAD D620 ` SUB 20 4EFS 1EFF LD E,FF 
4EAF 2861F JR 2 CONT 4EF7 CD1041 CALL CK-Y 
4EB1 0 JR C CONT 4EFA 1 CALL PLI? 
4EB3 ES PUSH HL 4EFD C1 POP BC 
4EB4 2600 LD ۵0 ۰ 4EFE 1 POP DE 
4EB6 6F LD L,A SEFF 1 POP HL 
4EB7 09 ADD HL,BC 4FOO 1 POP AF 
4EB8 44 LD B,H ۱ ۳01 14% INC 0 
4EBS 4D LD C,L 4FO2 03 INC BC 
4EBA OS DEC B ۱ ۴۳03 BA CP D 
EBB 0 . INER تا‎ ۴۳04-28665 - -- e NEXT = 
4EBC 1 - POPHL 4FO6 1801 JR BIT> 
4EBD 2811 JR Z CONT - 
4EBF ES ` PUSH HL 
%ECO 0 - LD 8 
4EC1 69 LD L,C 
4EC2 010001 LD BC,0100 
4ECS A7 - AND A 
4EC6 2 SBC HL, BC 
4ECB 44 LD ۷۷ 
4ECS “4D LD.C,L 
4ECA 1D - DEC E 
4ECB 3EFF - LD A,FF 
4ECD BB ۱ CP E 
4ECE El POP HL 
4ECF CR RET 2 


SEDO 3 CONT INC HL 


D 
D 
D 
D 


ECIMAL DAT 


177 170 
130 


OOO OIA ODO 
Beb peb and هل قۇقۇ‎ al هر‎ ed هخ نو دوم‎ 
<.J i Jı ۲ & GD Cj FU نا‎ a FJ €) 
# Co Ni Jı p Ci ND I O & N) 


RD RD ND N) ۵ DMD RD RD MAM RDN) 


D 
0 


9530 NEXT N 

9540 IF 414041 THEN PRINT “CHE 
` CKSUM ERROR" 

6699 REM 


CHECKSUM =14041 


. Listing 3: BASIC PORTION OF H.C. MLE BECODER. 


E 22 ح‎ << 0:2 
19 LET HR=19400 ۱ 
20 IF USR HR THEN CLS 
.. 89۵ 1۳_58 HR THEN RUN 
40 IF USR 20115 THEN 
REM >RUN 08 6 
S3 IF USR HR THEN LPRINT I; 
60 IF INKEY$="" THEN GOTO 0 
70 IF USR HR THEN RETURN 
80 STOP 
7999 REM #223 SHREB SAVE #242 
8000 IF USR HR THEN SAVE ۲ 
CODER” ,P 
8010 GOTO 8120 
8100 REM #2322 TIMEX SAVE e422 
8110 SAVE ۰ 
8129 LIST 20 
$000 REM 


RLE DECODER 
G.C. HARDER 9/87 
STORE RLE DATA AT 


$3200 = 32768 
BEFORE RUNNING. 


ooo REN 


déi 


Ee 


3 


R 
A 


Sp 
Sr 


1 
۳ 


Gë 


Fig. 2:MOSIC.S1E-175 40 


H 


TRANSFER 


MNEMONIC 


Ka HE* CCE NANE 
25 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 > < < < < ع و ه ع و‎ 
d ECSEsacscd TRAN LO . (LEN) Bea, 821 6۱9۳۲ Of data REM 
4 . CË pea ge Ee Adjust to exact length or 
= ۲ DEC Ec sRLE data 
Ké CE CEC Ec 
4e es CEC BC 
4 ee CEC EC 
D 0E CEC BC 
a AE EC E ` 
4i Z14340 LO HL,FLE> ,Fes. ۳2۶۲۵۳ addr. of RLE data 
A 110050 LO DE,DEST Bea, DE=Sstart addr. of storage 
<2 EZE LOIR و‎ ۲ ۵۳۶۴۶۳ RLE data to storage 
SE GER RET ¿Return tO basic 
dÉ 7S HALT 
4023 0 NOP 
405 05 LO A, (EC) 
4036 ES LEN: ACC A,B 
4095 2۶5 LD L,EA 
402] Sa RCO ۲۱ , HL 
403E 2635 LO H,39 

: BASIC part of routine. 
Cecinal Dune ; 
. 4 REM GOSUE +35]: *" 
Starting at address 0. D) BR GOSUB BTAN 
10 REM DATA 

22. 75 184 GL 11 41 11 11 20 RAND USR 4 
11 41 11 41 23 163 64 17 30 STOP 

0 126 237 176 201 4۵ SAVE “DOLLAR.RLE" 
Ending at éddress 16534. 


Thiz routine 
eirectiy fros the keyboard us 
the ۶1 1 6۷ 5 key press sequence 
KEY FRESS RESULTS 

1 1 

E REM 
SHIFT 3 THEN 

H Gdsue 
SHIFT $ CURSOR LEFT 
SHIFT Q THEN CELETED 
SHIFT ۵ CURSOR RIGHT 2 
SHIFT ۵ G MODE. SE 
SFACE ` INVERSE SPACE 
SHIFT . INVERSE COMMA 
SHIFT ENTER L MOCE 
SHIFT ENTER F MODE 

T RHD 
SHIFT P 8 
SHIFT F 
SHIFT F ge 
EHIFT P 7 
SHIFT F 8 
SHIFT © 7 
SHIFT ۴ SS 
SHIFT £ a 

5 =. 
EHIFT 9 © MODE ` 

SS INVERSE 7 
SHIFT ETER L MOCE 
SHIFT ENTER F MOCE 


Can be entered 


SHIFT 
SPACE 
SHIFT 
SPACE 
SHIFT 


SHIFT 


SHIFT 
SHIFT 
SHIFT 
SHIFT 


SHIFT 


SHIFT 
E 


Gone, 


۵ ها 


۴۱۵ 6۵ ۵ 2 ۵ 


press ENTER to put line 


H 
SPACE 
G MODE 


INVERSE SPACE 
L MODE 


THEN 
Gosus 
CURSOR LEFT 


‘THEN DEL ۶ ۲ ` 


CURSOR RIGHT ` 
G MODE ۱ 


into listing then; 
POKE 16515,75 


Check to see that. 2 REM looks | 
exactly like the 2 REM Shown in 


the 3isting above. 


Entre A EIMARY SCREEN FILE 


Wow that we know how to decode RLE files perhaps you would also like to be able to upload soee of your own easterpiesss, 
that you've created with SHREB, using the RLE standard. Again this is aot too differcult. As with the decoder you will need 
a ainisue of 64K of RAN. 


FROCEEDURE 


The first thing you have to do is have your graphic creation stored in the SHREB High Resolution Display File, froe 8192 te 
18735. Now look at Listing 5, this is the ENCODER. You will have to store this routine in your STATIC RAM board to use. You 
could use the 0221621 duep to POKE the values in each tise, but this is prone to errors. A better aethod would be to use 3 
BASIC prograa with sage pseudo-“BATA® staterents to hold the cade and FOKE it in autosatically. I leave this chore up to 
you. ° 


As shown, the ENCODER is located at 16129, you can put it at other locations if you want, it is free of CALLS and SUMP Ss. Do 
not store it somewhere in the HR-DFILE though! 


What will happen when you CALL the routine by RAND USR 16128? The first thing it does is aunch on your binary screen data 
and transfore it into suitable RLE data. The RLE data is then stored at address 32768 and upwards. Once all the screen data 
is processed it will then autosatically create a 0 REM BATA line of suitable size to hold the ALE file. If your RLE file is 
too Large ta store in 16K an error report 4 will result-°out of eener, If the file is rot too large then it will be 
transported to the 0 REM DATA Line. Once in the 0 REM DATA line the file is in a suitable fore for uploading by 1۲۲80 as an 


۵521] file to any ۲6۵۵۱۵ terainal. It can then be decoded by any RLE decoder prograe which tests for the proper RLE header, 
such as the one presented earlier. 


ês an evaeple, once the RLE file is stored in the 0 REM DATA line SAVE it a few tines to tape, then LOAD 11180 and relocate 
ta 22749. Before geing on line, reLOAD your RLE file. When it’s LOADed re-enter ZXTG0, call up a BBS and do a noreal upload. 
The epload will consist only of the encoded picture data. Also, your RLE file contains the proper ending code sequence. 


fs a ncte, before running the encacer you should NEN the cosputer to clear the entire BASIC area for the eaxieua possible 


EES 322 45 FD3437 INC (OFF>) 
3F48 ۳ LC A,TE 
LISTING 5: RLE ENCODER PROGRAM. 2F4A FOBE37 CP ۱ 
: 3۴40 200A JR NZ NXBT 
3۳*۴ 77 LUF1 Lo HL) A 
e 2 ۱ 5۳50 2 INC HL 
GE 354 Ze LE ۱۲۱6 o 
2F90 CD220F_ NOOD CALL FAST SESE 2۶ LC (ON >),C 
2203 ۴۵36326 O] LO (FLGB) Aën FEES 1S" E 
a NT A pag ۰ Sei ` ee H 
EE e? der ZER 2۳59 ۴۵3533 NXBT CEC (LOOP) 
SF2c 98 LO ۳ SE E uF iz BITS 
GFF 5 LO (ON ( 6 SFSE 8 JR_ ا‎ 
2F12 7 LD (OFF>),C 322 50 ۳0832355 BIT+ FES O, (FLES? 
3۴15-868 l LD (HL),16_. 3۴24 ۴0۵683242 ` BIT 1, (FLGB) 
SEI دا جح‎ INC HL 3FE8 53 JR NZ SKP2. 
3F15 3647 "Cp (HA, 47 3۴5۲ 248 LO A, (OFF>) 
2FiA 23 INC HL 2۳5 77 LD (HL),A 
Stin 3648 LO (HL) ,48 FEE FD7T137 LO (OFF>),C 
3۴10 23 INC HL 3۳74 23 INC HL 
3۳1۶ FO363308 BYTS LD (LOOP) ,@38 3۳22 ۴09۵8320۶ SKP2.SET 1, (FLGB) 
3۳22 ER EX GE, HL 5۳ 5 5 INC (ON >); 
3۳23 45 LD B, (HL) 2F79 3E7E LC A.7E 
3۳24 23 INC HL SFTB 5 cP (ON >) 
3F25 53 LD A,38 : SFTE 236۴ ۰ JUR 2 
3۳27 BC CP H 2 36 1807 JR ۲ 
3۴23 ES EX DE ,HL 32222 3618 END> LO (HL) 8 
3F 2082357 JR Z END» 3۴34 23 INC HL 
3۴28 9 BITS B FSS 3647 LO (HL) ,47 
3۴ 2* 4 JR NC + 23۴37 23 l INC HL 
3۴2۴ ۴06832625 ` RES .1, (FLGB) 323۶ 364E LC (HL) ۴ 
3F33 FOCB3246 BIT 8, ۲۱ . 3۴88 3 INC HL 
3F37 2008 JR NZ SKP1 3FaB 53 LO BC.STOR 
3F39 343640 LD A, (ON >) 2FSE A7 AND A 
3F3C 77 LD ۲۵ FEF 2 SBC HL,BC 
SF2D FD7136 LD (ON DO; . 391 ES FUSH HL 
3F40 23 INC HL 


3F41 083226 SKP1 SET @, (FLGB) 


2۴92 e1acea Lo 86,۵۵۶ SES 

3۴96 oa ۱ ACO ۲۱ ۲ if 

3۳36 44 LG B.H 353 

3۴97 4D LO Gab Si 

3F98 217040 LC ۲ ۵ وعح‎ 

53۴98 CS FUSH BC 55 

5۴96 oi INC BC a? Ze 
3۴96 3 IHC BC 2a3 142 
3۴9۶ 3 INC EC Sa a 
3۴9۴ 3 INC B2 119 413 
SFAQ 69۶0 CALL BCSP 233 EEE 
SFA3 Ci FOF BC Bs EE 
5۴84 23 INC HL Zä <2 
3۴25 23 INC HL 54 i13 
FAG 3609 LC (HL) ,@a Ss ap 
SEAS 5 INC HL 253 So 
SFAQ 50 . LC (HL) هم‎ Sa ao 
3۴88 23 INC HL SA 353 
SFAC 71 Lo tHL),c 253 So 
3FAL 23 INC HL Sa 326 
SFAE 70 LO (HL),B ۰ SI ve 
SFAF 22 INC HL 35 71. 
3۴80 6258 LC (HL? ,EA 35 1 _ @ ` 
3FB2 23 IWC AL 66 22a 3 
3۴85 3622 LE (HLH. SS 62 $9 23 
SFBS 22 INC HL 2 2 a 
3۳86 25 LO (HL) ۴ 5 jas 3s 
5۴85 22 INC HL 35 54 ۵ 
3۳85 3632 LD ۲۱۱ ور‎ 112 35 Sa 
SFEB 22 INC HL 41 25 54 
SFEC 2626 LC (HL) ,26 57 35 وه‎ 
SFBE 23 INC HL 118 35 54 
SFBF 3676 LF (HL), 76 235 33 @ 
3۴61 23 INC HL 27 237 مخ‎ 
3۴62 6 LD (HL) 6 12 64 43 
SFC4 3 INC HL 43 15 

SFCS Ci FOF BC 

3۴65 EB EX DE,HL 

SFCT 0 LD HL, STOR 

3FCA 0 LDIR 

FCE Sagan LE (PEND) pp 

SFC EDS3? ۰ (PEND) DE CHECKSUM PROGR! 
3۴01 28048 LO HL, (DFIL} l iù 
SES 28 CEC HL 

SFDS 5 * (HL), 76 osom ET X= 

3FD7 C3280F JP SLOW e pi 


d 9510 FOR N=16128 TO 16345 
9520 LET XK=xX+PEEK N 
9530 NEXT N 
9540 IF ۱2۵۵211 THEN PRINT ۶۴ 
CKSUM ERROR" 


CHECKSUN=28211 


Fig. 4:۱50۳409. 55-15 0 Pans 


Se 


A Procedure For Downloading Crunched RLE Files To Any Computer System. 


Most of the RLE picture files available from the GREYMATTER BBS have been 
crunched in order to conserve disk space. Normally, you would download 

the crunched file and then use an "uncrunch" utility to restore them. This 
is fine if you have a C/PM system, however if you do not then you must find 
an alternative method. Fortunately, there is a built-in "backdoor" method 
which can be used to automatically uncrunch the files. The procedure should 
be generally applicable to all computer systems, although the specifics will 
Wary. 


I have successfully used the method numerous times using a TIMEX/SINCLAIR 
1500 computer and the terminal program ZX*TERM-80. 


The key to uncrunching the RLE files is the C/PM "TYPE" command. The TYPE 
command is used to view/read the contents of a file. Some TYPEable files 

would be ones with the extensions such as TXT, DOC, BAS, HLP, etc. These, 
however, are not crunched files Extensions such as TZT, DZC, BZS, HZP, 

etc indicate that the files have been compressed. 


For example, "README.TXT" and "README.TZT" would both be the same text file, 
but the latter has been compressed. Fortunately, the TYPE command can dis- 
tingguish between TXT and TZT. The end result is that "TYPE README.TXT" 
and "TYPE README.TZT" will result in identical output. 


Since RLE files are by design just ASCII encoded graphic information, if 
we could capture this data in uncrunched form the RLE picture could then - 
be decoded in a normal fashion. 


PROCEDURE 


Select drive B5 which holds the RLE files. 


m 
H 


N 


Select a LBR file use "LUX RLE1" for example. 


Initialize/clear/open your input capture buffer. 


w 


4. Select a crunched RLE file for capture, for example BBUNNY and TYPE it, 
your input line should look like; 
-B5:RLE1.LBR-—>TYPE BBUNNY.RZE 


5. After pressing <cr> you must quickly disable the paging option by using 
CONTROL Z before the actual RLE data is sent, or the data will be cor- 
rupted by the paging prompts. This is probably the trickiest part of 
the method and may take some practice. The first three characters of 
the RLE data consist of ASCII codes 1B 47 48 (hex) which would ap- 
pear on your terminal as <ESC> followed by GH. Thses are the opening 
header of the RLE file. : 


6. When the transfer is completed you'll see the system prompt again. At 
this point you should have an uncrunched copy of the RLE file stored 
in your input buffer. Save the file at this time for later decoding. 
follow the procedure again to capture another RLE file. 


The most important items to remember are to clear/open your input capture 
buffer before TYPEing the file and shutting off the paging prompts. 


Since "TYPE" is essentially a form of ASCII file transfer there is no built-in 
error checking on the data being sent. This is the biggest disadvantage of 
using this method for data transfer. This means you may get some errors in 
the RLE data, usually characterized by non-standard ASCII characters being 
displayed during the transfer, which can cause some drastic offsets in the 
final picture. These are repairable by using some graphic design programs. 

If you notice alot of line noise it is probably better to wait for some other 
time to transfer the RLE files. 


Hope this helps. 
Regards; 


Gregory C. Harder Sept. 20, 1988 


